home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d6 / rosej402.arc / JOURNAL.DOC < prev    next >
Text File  |  1991-04-15  |  65KB  |  1,516 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                    ROSEWOOD JOURNAL
  10.  
  11.  
  12.  
  13.                                      Version 4.02
  14.  
  15.  
  16.  
  17.                            O P E R A T I N G   M A N U A L
  18.  
  19.  
  20.  
  21.  
  22.                                   ROSEWOOD SOFTWARE 
  23.                                  135-10 Livonia Place
  24.                              Scarborough, Ontario M1E 4W6
  25.  
  26.                         (416) 284-6119   CompuServe 70461,2507
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                                   _______
  33.                              ____|__     |               (R)
  34.                           --|       |    |-------------------
  35.                             |   ____|__  |  Association of
  36.                             |  |       |_|  Shareware
  37.                             |__|   o   |    Professionals
  38.                           -----|   |   |---------------------
  39.                                |___|___|    MEMBER
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                               (C) Copyright 1988, 1991 
  48.  
  49.                                           by
  50.  
  51.                         Rosewood Software and Bert Christensen
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                    ROSEWOOD JOURNAL
  60.  
  61.  
  62.                                   TABLE OF CONTENTS
  63.  
  64.           ACKNOWLEDGEMENTS  . . . . . . . . . . . . . . . . . . . . . .   4
  65.  
  66.           WARRANTY DISCLAIMER . . . . . . . . . . . . . . . . . . . . .   4
  67.  
  68.           ASSOCIATION OF SHAREWARE PROFESSIONALS OMBUDSPERSON . . . . .   4
  69.  
  70.           LICENSE . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  71.  
  72.           REGISTRATION INFORMATION  . . . . . . . . . . . . . . . . . .   6
  73.  
  74.           THIS MANUAL . . . . . . . . . . . . . . . . . . . . . . . . .   6
  75.  
  76.           TYPOGRAPHICAL CONVENTIONS . . . . . . . . . . . . . . . . . .   7
  77.  
  78.           DECISION LINES  . . . . . . . . . . . . . . . . . . . . . . .   7
  79.  
  80.           OVERVIEW  . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  81.  
  82.           SYSTEM REQUIREMENTS . . . . . . . . . . . . . . . . . . . . .   7
  83.  
  84.           DEFINITIONS . . . . . . . . . . . . . . . . . . . . . . . . .   8
  85.                Journal  . . . . . . . . . . . . . . . . . . . . . . . .   8
  86.                Invoice  . . . . . . . . . . . . . . . . . . . . . . . .   8
  87.                Ledger . . . . . . . . . . . . . . . . . . . . . . . . .   8
  88.                Statement  . . . . . . . . . . . . . . . . . . . . . . .   8
  89.  
  90.           GETTING STARTED . . . . . . . . . . . . . . . . . . . . . . .   8
  91.  
  92.           CONFIG.SYS  . . . . . . . . . . . . . . . . . . . . . . . . .   8
  93.  
  94.           USING THE PROGRAM WITH YOUR OWN DATA  . . . . . . . . . . . .   9
  95.                INSTALLATION ON A TWO FLOPPY DISK SYSTEM . . . . . . . .   9
  96.                INSTALLATION ON A HARD DISK  . . . . . . . . . . . . .    10
  97.                AFTER ROSEWOOD JOURNAL IS INSTALLED  . . . . . . . . .    10
  98.  
  99.           LISTING OF FILES  . . . . . . . . . . . . . . . . . . . . .    10
  100.  
  101.           NOTE ON NUMERICAL ENTRIES . . . . . . . . . . . . . . . . .    12
  102.                Credit notes . . . . . . . . . . . . . . . . . . . . .    12
  103.  
  104.           NOTE ON CUSTOMER ACCOUNT NUMBERS  . . . . . . . . . . . . .    12
  105.  
  106.           USING YOUR PRINTER  . . . . . . . . . . . . . . . . . . . .    12
  107.  
  108.           DETAILED PROGRAM INSTRUCTIONS . . . . . . . . . . . . . . .    13
  109.  
  110.           MAIN MENU . . . . . . . . . . . . . . . . . . . . . . . . .    13
  111.  
  112.                                           2
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                    ROSEWOOD JOURNAL
  121.  
  122.  
  123.                Enter Invoice Data . . . . . . . . . . . . . . . . . .    13
  124.                Change Invoice Data  . . . . . . . . . . . . . . . . .    15
  125.                Enter Payments on Account  . . . . . . . . . . . . . .    15
  126.                Change Payments on Account . . . . . . . . . . . . . .    16
  127.                Accounts Receivable Menu . . . . . . . . . . . . . . .    16
  128.                Reports Menu . . . . . . . . . . . . . . . . . . . . .    16
  129.                Utilities Menu . . . . . . . . . . . . . . . . . . . .    16
  130.                Exit Program . . . . . . . . . . . . . . . . . . . . .    16
  131.  
  132.           ACCOUNTS RECEIVABLE MENU  . . . . . . . . . . . . . . . . .    16
  133.                View or Print Individual Accounts  . . . . . . . . . .    17
  134.                Print All Statements for Month . . . . . . . . . . . .    17
  135.                Establish New Customer Accounts  . . . . . . . . . . .    17
  136.                Modify Customer Data . . . . . . . . . . . . . . . . .    17
  137.                List Customer Accounts . . . . . . . . . . . . . . . .    17
  138.                Reports Menu . . . . . . . . . . . . . . . . . . . . .    18
  139.                Exit to Main Menu  . . . . . . . . . . . . . . . . . .    18
  140.  
  141.           REPORTS MENU  . . . . . . . . . . . . . . . . . . . . . . .    18
  142.                Monthly Report . . . . . . . . . . . . . . . . . . . .    18
  143.                Yearly Report  . . . . . . . . . . . . . . . . . . . .    18
  144.                Accounts Receivable List . . . . . . . . . . . . . . .    18
  145.                Payments on Account List . . . . . . . . . . . . . . .    18
  146.                General Ledger Report  . . . . . . . . . . . . . . . .    18
  147.                Accounts Receivable Menu . . . . . . . . . . . . . . .    19
  148.                Exit to Main Menu  . . . . . . . . . . . . . . . . . .    19
  149.  
  150.           UTILITIES MENU  . . . . . . . . . . . . . . . . . . . . . .    19
  151.                Change Company Details . . . . . . . . . . . . . . . .    19
  152.                DOS Functions  . . . . . . . . . . . . . . . . . . . .    20
  153.                End of Period Housekeeping . . . . . . . . . . . . . .    20
  154.                Change Screen Colours  . . . . . . . . . . . . . . . .    21
  155.                Change Tax Names . . . . . . . . . . . . . . . . . . .    22
  156.                Change Softkey Settings  . . . . . . . . . . . . . . .    22
  157.                Print Labels . . . . . . . . . . . . . . . . . . . . .    22
  158.                Exit to Main Menu  . . . . . . . . . . . . . . . . . .    23
  159.  
  160.           FILE LENGTHS AND NAMES IN ROSEWOOD JOURNAL  . . . . . . . .    23
  161.  
  162.           CONVERTING FILES FROM PREVIOUS VERSIONS OF ROSEWOOD JOURNAL    23
  163.  
  164.           INTEGRATING YOUR PREVIOUS RECEIVABLE FILES  . . . . . . . .    24
  165.  
  166.           PROGRAMMING DETAILS . . . . . . . . . . . . . . . . . . . .    24
  167.  
  168.           CHANGES AND ENHANCEMENTS  . . . . . . . . . . . . . . . . .    25
  169.  
  170.           SHAREWARE . . . . . . . . . . . . . . . . . . . . . . . . .    25
  171.  
  172.  
  173.                                           3
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.                                    ROSEWOOD JOURNAL
  182.  
  183.  
  184.                                    ACKNOWLEDGEMENTS
  185.  
  186.           I would like to  thank Ed Somervell from Santa  Clara, California
  187.           for his many suggestions  and help in debugging, those  users who
  188.           took the time to  write to me with suggestions  for improvements,
  189.           and finally my wife,  Louise, who saw me through  the programming
  190.           of "Journal" as I saw her through her doctoral thesis.
  191.  
  192.  
  193.  
  194.                                  WARRANTY DISCLAIMER
  195.  
  196.  
  197.           Rosewood  Software makes  no  warranty of  any  kind, express  or
  198.           implied,   including  without   limitation,  any   warranties  of
  199.           merchantability and/or fitness for a particular purpose. Rosewood
  200.           Software  shall not  be liable  for any damages,  whether direct,
  201.           indirect, special,  or consequential,  arising from a  failure of
  202.           this  program to  operate  in the  manner  desired by  the  user.
  203.           Rosewood Software shall  not be liable for any  damage to data or
  204.           property which may be caused directly or indirectly by use of the
  205.           program.
  206.  
  207.           IN NO EVENT  WILL ROSEWOOD  SOFTWARE BE LIABLE  FOR ANY  DAMAGES,
  208.           INCLUDING ANY  LOST PROFITS, LOST SAVINGS OR  OTHER INCIDENTAL OR
  209.           CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE
  210.           THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  211.  
  212.  
  213.                  ASSOCIATION OF SHAREWARE PROFESSIONALS OMBUDSPERSON
  214.  
  215.  
  216.           Rosewood  Software is a  member of  the Association  of Shareware
  217.           Professionals (ASP). ASP  wants to make  sure that the  shareware
  218.           principle  works  for  you.  If  you  are  unable  to  resolve  a
  219.           shareware-related problem  with an  ASP member by  contacting the
  220.           member  directly, ASP may be  able to help.  The ASP Ombudsperson
  221.           can help you resolve a dispute or problem with an ASP member, but
  222.           does not provide technical  support for members' products. Please
  223.           write  to the ASP Ombudsperson  at 545 Grover  Road, Muskegon, MI
  224.           49442-9427 or  send a CompuServe  message via CompuServe  Mail to
  225.           ASP Ombudsperson 70007,3536.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.                                           4
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.                                    ROSEWOOD JOURNAL
  243.  
  244.  
  245.                                        LICENSE
  246.  
  247.           Rosewood Journal is  Copyright (C) 1991 by Rosewood  Software and
  248.           Bert Christensen.
  249.  
  250.           Rosewood   Journal  is   distributed  under   the  user-supported
  251.           Shareware concept.  Non-registered users of Rosewood  Journal are
  252.           granted a limited  license to  use Rosewood Journal  for a  trial
  253.           period   not  to  exceed  90  days  in  order  to  determine  its
  254.           suitability for their purposes.  Any use of non-registered copies
  255.           of Rosewood Journal beyond this trial period is forbidden.
  256.  
  257.           Registering a copy of Rosewood  Journal allows a user to make  as
  258.           many  copies of  Rosewood Journal as  desired, and  to use  it on
  259.           various  machines,  but  the  same registered  copy  of  Rosewood
  260.           Journal may not  be in use on  more than one machine at  the same
  261.           time.
  262.  
  263.           No user may modify Rosewood Journal in any way, including but not
  264.           limited  to  decompiling,  disassembling,  or  otherwise  reverse
  265.           engineering the program.
  266.  
  267.           All users are granted a license  to copy Rosewood Journal for the
  268.           trial use of others,  subject to the above restrictions  and also
  269.           the following:
  270.  
  271.                Rosewood  Journal  must  be  copied  in  absolutely un-
  272.                modified form, including all program files and complete
  273.                documentation;
  274.  
  275.                No licensee  may accept  or request  a charge or  other
  276.                payment for Rosewood Journal except for a disk handling
  277.                charge of up to $12.
  278.  
  279.           Operators of electronic bulletin  board systems may post Rosewood
  280.           Journal for downloading by their users only as long as  the above
  281.           conditions are met.
  282.  
  283.           Distributors of  public  domain or  user-supported  software  may
  284.           distribute  copies  of  Rosewood  Journal subject  to  the  above
  285.           conditions only after obtaining written permission from  Rosewood
  286.           Software. All  not-for-profit organizations or vendor  members of
  287.           the Association  of Shareware Professionals are  exempt from this
  288.           restriction.  In  any case,  no charge  may  be made  for  a disk
  289.           containing Rosewood Journal except for  a disk handling charge of
  290.           up to $12.
  291.  
  292.  
  293.  
  294.  
  295.                                           5
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.                                    ROSEWOOD JOURNAL
  304.  
  305.  
  306.                                REGISTRATION INFORMATION
  307.  
  308.           Rosewood Journal is  not in any  way free software.  If you  have
  309.           tried Rosewood  Journal  and  have decided  that  it  suits  your
  310.           purposes,  please register.  Continued  use  of Rosewood  Journal
  311.           beyond a trial period is an infringement of copyright laws.
  312.  
  313.           Registered users will receive notices of major updates and of any
  314.           new  products  which  may  be introduced  by  Rosewood  Software.
  315.           Registered users will receive preference when requesting support.
  316.  
  317.           Registration costs $38 US  or $45 Canadian. Upon receipt  of your
  318.           registration fee,  a disk  containing the  latest version of  the
  319.           program  and the documentation will  be mailed to  you. This disk
  320.           will also have a Conversion  program which will convert  Rosewood
  321.           Journal  versions 2.xx  and  3.xx files  to  version 4.xx  and  a
  322.           program  which will  remove the  exhortations to  register. Eval-
  323.           uation disks which do not include registration may be ordered for
  324.           $10 US or  $12 Canadian.  Ontario residents please  add 8%  sales
  325.           tax. Write for information on quantity purchases.
  326.  
  327.           When  ordering, please print and  use the file "ORDER.FRM", which
  328.           was included  on your distribution  disk, or simply  include your
  329.           name,  address, company  name, and  your telephone  number, along
  330.           with a cheque or money order to:
  331.  
  332.                               Rosewood Software
  333.                               135-10 Livonia Place
  334.                               Scarborough, Ontario M1E 4W6
  335.  
  336.           Cheques  in US  dollars must  be  drawn on  US banks.  Cheques in
  337.           Canadian dollars must be drawn on Canadian banks.
  338.           C.O.D. orders are not accepted.
  339.  
  340.  
  341.           Thank you for supporting Rosewood Software and Shareware.
  342.  
  343.  
  344.                                    THIS MANUAL
  345.  
  346.  
  347.           This manual is designed to be succinct. This means that not every
  348.           little,  obvious command such as  "Send Output to  Screen <S>, or
  349.           Printer <P>" will be  described in detail. This keeps  the manual
  350.           short and easier to read.
  351.  
  352.  
  353.  
  354.  
  355.  
  356.                                           6
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.                                    ROSEWOOD JOURNAL
  365.  
  366.  
  367.                               TYPOGRAPHICAL CONVENTIONS
  368.  
  369.           Keyboard  commands such as  "Enter", "Esc", etc.  are enclosed in
  370.           angle brackets <>.  When instructed to  enter "Esc" for  example,
  371.           the  manual and  the program  show the  command as <Esc>.  Do not
  372.           enter the angle brackets. They are  there simply to tell you that
  373.           a  keyboard  entry  is  expected.  The  program  itself  is  case
  374.           insensitive. You can enter any combination of upper or lower case
  375.           characters.
  376.                                     DECISION LINES
  377.  
  378.           A "decision  line" is a line  (or more) of text,  generally at or
  379.           near the bottom of the screen, which prompts  you for a decision.
  380.           For  example, you  may see a  line which  says, "<Esc>  to abort.
  381.           <Enter> to  continue".  In Rosewood  Journal,  this is  called  a
  382.           "decision line".
  383.  
  384.                                        OVERVIEW
  385.  
  386.           Rosewood  Journal  is a  sales  journal  and accounts  receivable
  387.           program  suitable for  small to  medium  sized businesses.  It is
  388.           especially suitable for businesses which record sales on serially
  389.           numbered invoices. A variety of reports can be viewed or printed,
  390.           including monthly  and yearly  sales, accounts receivable  lists,
  391.           and aged customer statements and mailing labels. Rosewood Journal
  392.           is an adjunct to  your general ledger program, not  a replacement
  393.           for it. Rosewood  Journal generates a special  report which tells
  394.           you  the  amounts and  to  which accounts  your  sales, receipts,
  395.           accounts  receivable and  sales tax  should be  entered. Rosewood
  396.           Journal  is  menu driven  and  designed  to minimize  keystrokes.
  397.           Rosewood Journal is a friendly program. It will complain, nicely,
  398.           via  beeps and a refusal  to continue if  you enter inappropriate
  399.           data  by  mistake.  In some  cases,  it  will  even correct  your
  400.           spelling  (try entering "Febuary" when you are asked to enter the
  401.           name of a month).
  402.  
  403.                                  SYSTEM REQUIREMENTS
  404.  
  405.           Rosewood Journal requires the following minimum configuration:
  406.  
  407.                IBM or compatible computer
  408.                MS/PC-DOS 2.00 or later
  409.                1 360K floppy drive, at the very minimum 
  410.                320K RAM
  411.                Printer if you wish printed reports and statements.
  412.  
  413.           Rosewood Journal will make good use of:
  414.  
  415.  
  416.  
  417.                                           7
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.                                    ROSEWOOD JOURNAL
  426.  
  427.  
  428.                Another drive (360K, 1.2M,  5", 3.5", hard drive,  ram disk)
  429.                Laser printer (for nicer customer statements).
  430.  
  431.           In  short,  Rosewood Journal  should  work on  most  MS-DOS based
  432.           computers.
  433.  
  434.           Some maximums:
  435.  
  436.                Maximum individual invoice amount is $99,999.99
  437.                Maximum yearly sales amount is $9,999,999.99
  438.                Maximum number of entries per year is dependent on disk
  439.                     storage.
  440.  
  441.                                      DEFINITIONS
  442.  
  443.           During  the testing  phase  of  this  program, some  people  were
  444.           confused by  some of the  terms used  in Rosewood Journal  and in
  445.           bookkeeping generally. Therefore, some dictionary definitions are
  446.           included   from  Webster's   New  Twentieth   Century  Dictionary
  447.           (unabridged)1978
  448.  
  449.                Journal,  n, in bookkeeping, (a)  a daybook; (b) a book
  450.                of original entry,  used, in  the double-entry  system,
  451.                for recording  all transactions  with an indication  of
  452.                the special accounts to which they belong.
  453.  
  454.                Invoice,  n, an  itemized list  of goods  shipped to  a
  455.                buyer,  stating  quantities, prices,  shipping charges,
  456.                etc.
  457.  
  458.                Ledger,  n, in bookkeeping, the  book of final entry in
  459.                which  a  record  of  debits, credits,  and  all  money
  460.                transactions is kept.
  461.  
  462.                Statement,  n,  an  abstract of  a  financial  account,
  463.                especially of money due.
  464.  
  465.  
  466.  
  467.  
  468.                                    GETTING STARTED
  469.  
  470.           IMPORTANT: WHEN INSTALLING THIS PROGRAM IN ANY MODE, FLOPPY DISKS
  471.           OR  HARD   DRIVE,  YOUR  "CONFIG.SYS"  FILE  MUST  HAVE  A  LINE,
  472.           "FILES=15"  AND,  OPTIONALLY,  A   LINE  "BUFFERS=12".  IF   YOUR
  473.           "CONFIG.SYS" FILE DOES NOT  HAVE THE "FILES=15" LINE  THE PROGRAM
  474.           WILL,  AT SOME  POINT  TERMINATE WITH  A  "TOO MANY  FILES  OPEN"
  475.           MESSAGE.  SEE  YOUR DOS  MANUAL  FOR  DETAILS ABOUT  "CONFIG.SYS"
  476.  
  477.  
  478.                                           8
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.                                    ROSEWOOD JOURNAL
  487.  
  488.  
  489.           FILES. THESE NUMBERS ARE  THE MINIMUM REQUIRED. THE  PROGRAM WILL
  490.           RUN WITH MORE BUT NOT FEWER FILES.
  491.  
  492.  
  493.           The best  way to  learn the  program is to  use the  sample files
  494.           provided  with it. The  sample files  concern a  small fictitious
  495.           business called "Ripley's Fine Catering". Only two months of data
  496.           are  supplied, January and February  1990. Here is  how to start,
  497.           using the sample files:
  498.  
  499.           Copy  "RJ.EXE" and all files  with the extension  ".DAT" from the
  500.           Rosewood Journal Distribution Disk or from the archived file to a
  501.           disk  formatted with the "format/s"  option. In other words, copy
  502.           it to a formatted disk with system. Then place this disk in drive
  503.           "A" and reboot your  computer. At the "A>" prompt,  type "RJ" (no
  504.           quotation marks) and press <ENTER>. After an opening screen and a
  505.           brief initialization, you will come to a "Main Menu". From there,
  506.           explore the menus and the reports. Try entering some data of your
  507.           own to the sample months or to other months. If  you get confused
  508.           (unlikely),  consult the  manual.  Note, however,  that  Rosewood
  509.           Journal does  not write  invoices; it only  reports invoices  and
  510.           handles accounts receivable.  Also, "Gross Invoice  Amount" means
  511.           the total amount of the invoice INCLUDING sales tax(es).
  512.  
  513.                          USING THE PROGRAM WITH YOUR OWN DATA
  514.  
  515.           INSTALLATION ON A TWO FLOPPY DISK SYSTEM
  516.  
  517.           Copy the file "RJ.EXE" to a floppy  disk which has been formatted
  518.           with  the /S (system) option. Be sure that your "CONFIG.SYS" file
  519.           is as described above. Place this "Program Disk" in Drive "A" and
  520.           a formatted disk  in Drive "B" and, at the  "A>" prompt type "RJ"
  521.           (no quotation marks) and press <ENTER>. You will be asked whether
  522.           your monitor is  mono or colour. After the title  screen you will
  523.           be  asked to  enter  details  about  your  company  and  to  what
  524.           drive/directory  the  data will  be  kept.  After completing  the
  525.           configuration you will be at the Main Menu.
  526.  
  527.           The above  is only a suggested  installation. If you have  a high
  528.           density disk drive you could have the program and the data on the
  529.           same drive or in another directory. You can also use the data
  530.           drive/directory as the logged drive. This is done as follows:
  531.  
  532.                B:        (makes "B" the logged drive)
  533.                A:RJ        (starts  RJ.EXE in  drive "A"  while "B" is  the
  534.                          logged drive)
  535.  
  536.           It  is beyond  the  scope of  this  manual to  describe  the many
  537.           possibilities for installing the program. Please consult your DOS
  538.  
  539.                                           9
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.                                    ROSEWOOD JOURNAL
  548.  
  549.  
  550.           manual or  a person  familiar with  DOS if  you should  need more
  551.           help.
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.           INSTALLATION ON A HARD DISK
  559.  
  560.           To install Journal  on a  hard disk, create  a new directory  (we
  561.           suggest ROSEJOUR) and copy the file "RJ.EXE" into it. If you wish
  562.           to keep your data in a separate sub-directory create either a sub
  563.           from "ROSEJOUR" or another directory  from the root directory. It
  564.           is most  important that you  know the complete  path to the  data
  565.           directory because you will  be asked for it when  configuring the
  566.           program. Change the logged  drive/directory to the one which  has
  567.           RJ.EXE  in  it  and type  "RJ"  (no  quotation  marks) and  Press
  568.           <Return>. Answer  the various  configuration questions  until you
  569.           reach the Main Menu.
  570.  
  571.           There are  other  ways  to install  Rosewood  Journal.  The  most
  572.           important requirements are that Journal  must know where the data
  573.           files  are  located and  that the  computer  knows where  to find
  574.           "COMMAND.COM".  Consult your  DOS  manual if  you should  require
  575.           assistance.
  576.  
  577.           AFTER ROSEWOOD JOURNAL IS INSTALLED
  578.  
  579.           Put the Rosewood  Journal Distribution  Disk in a  safe place  in
  580.           case  your  working  copies get  damaged  in  some  way. This  is
  581.           probably  a good  time to issue  the usual warning.  BACK UP YOUR
  582.           DATA DISKS OFTEN, PREFERABLY AFTER  EACH USE. Without a  back-up,
  583.           all your data  will have to be re-entered should  the original be
  584.           lost or corrupted. There, you've been warned!
  585.  
  586.  
  587.                                    LISTING OF FILES
  588.  
  589.                "RJ.EXE" is the main program.
  590.  
  591.                "JOURNAL.DOC" is this manual.
  592.  
  593.                "README.DOC" a brief overview and instruction.
  594.  
  595.                "ORDER.FRM"  an order  form  for  registering  Rosewood
  596.                Journal. Please use it.
  597.  
  598.                "FILES.DOC" is a listing of files similar to this one.
  599.  
  600.                                           10
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.                                    ROSEWOOD JOURNAL
  609.  
  610.  
  611.           Rosewood Journal generates its own data file names. After running
  612.           the  program, you will  find several files on  your data disk (or
  613.           the program disk if you are using the sample data). They are:
  614.  
  615.                "COMPANY.CNF"  is  a  file containing  details  of  the
  616.                company for which the  books are being kept as  well as
  617.                the disk drive/directory where  the data files are kept
  618.                and the starting month of the business's fiscal year.
  619.  
  620.                "COLORSCN.CNF" is  the file which stores  the screen colours
  621.                used in the program.
  622.  
  623.                "TAXTYPES.CNF" stores  the number  of sales taxes  which you
  624.                must account for and their names.
  625.  
  626.                Files  with the  extension ".CNF" are  ALWAYS on  the LOGGED
  627.                drive.
  628.  
  629.                "SOFTKEY.DAT"  is  the  file which  contain  the  user-
  630.                configured  softkey  data  for  the  invoice  entry and
  631.                customer accounts modules.
  632.  
  633.                "RECEIVE.DAT" stores accounts receivable data.
  634.  
  635.                "CUSTACCT.DAT"   stores   names,   addresses,   account
  636.                numbers, etc.  for persons and businesses  which owe or
  637.                have owed you money.
  638.  
  639.                "monyr.DAT"  e.g.  JAN90.DAT  stores  details  of  each
  640.                invoice  entered in  any particular  month. There  is a
  641.                separate file for each month.
  642.  
  643.                "TOTALSyr.DAT"  e.g.  TOTALS90.DAT  stores the  summary
  644.                data for each month of any fiscal year.
  645.  
  646.                In addition  to the  above files,  two other  files are
  647.                produced after using  the "End of period  housekeeping"
  648.                option   from   the    "Utilities"   Menu.   They   are
  649.                "RECEIVE.OLD"  and  "CUSTACCT.OLD".  These   files  are
  650.                generated  to preserve  old data  before the  files are
  651.                purged of unused data at year-end.
  652.  
  653.  
  654.  
  655.  
  656.                                       WARNING!!
  657.  
  658.           As with  most programs  using disk  files,  it is  of the  utmost
  659.           importance  that data disks not be exchanged while the program is
  660.  
  661.                                           11
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.                                    ROSEWOOD JOURNAL
  670.  
  671.  
  672.           running  or data may be lost. Also,  the program must be ended by
  673.           the "Exit program" command from the Main Menu. 
  674.  
  675.  
  676.  
  677.  
  678.                               NOTE ON NUMERICAL ENTRIES
  679.  
  680.           Rosewood Journal  expects a decimal  point when one  is required.
  681.           That is,  an amount such as  149.95 must be  entered <149.95> and
  682.           not <14995>.  However, if  you have  an amount  to enter such  as
  683.           149.00, it  may  be  entered  as  <149>.  Credit  notes  (reverse
  684.           entries) are  preceded by  a "-"  (minus sign). Rosewood  Journal
  685.           will complain with beeps and will refuse to go forward if you try
  686.           to enter alphabetical  characters where numerical  characters are
  687.           expected.
  688.  
  689.  
  690.                            NOTE ON CUSTOMER ACCOUNT NUMBERS
  691.  
  692.           Rosewood  Journal assigns  its  own account  numbers to  customer
  693.           accounts.  When asked to "enter  an account number  or press zero
  694.           for  a  new account",  you must  use  either an  existing account
  695.           number  as  shown,  or  press  zero  for  a  new  account.  After
  696.           performing "End of period housekeeping" (see  Utilities), account
  697.           numbers  which you have decided to delete will be re-used for new
  698.           accounts  in order to keep  the "CUSTACCT.DAT" file  as small and
  699.           fast as possible. Any attempt to assign arbitrary account numbers
  700.           of your own  will make  Rosewood Journal complain  or will  cause
  701.           erroneous results.
  702.  
  703.                                   USING YOUR PRINTER
  704.  
  705.           Rosewood Journal should work with most printers since it  doesn't
  706.           use  any special codes.  The only code  used is  a formfeed, "FF"
  707.           (ASCII 12) which is used to move the paper to the top of the next
  708.           page.  This  is  almost a  universal  code  and  should cause  no
  709.           problems. If your printer has a DIP switch to turn on and off the
  710.           "skip over  perforations" feature,  this switch should  be turned
  711.           off. If it  is on the printer  may feed an extra,  blank sheet of
  712.           paper  between printed pages. If you get printing errors, such as
  713.           condensed print, try turning  off your printer and turning  it on
  714.           again to clear any codes remaining from a previous program.
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.                                           12
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.                                    ROSEWOOD JOURNAL
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.                             DETAILED PROGRAM INSTRUCTIONS
  741.  
  742.  
  743.                                       MAIN MENU
  744.  
  745.                               1. Enter Invoice Data
  746.                               2. Change Invoice Data
  747.                               3. Enter Payments on Account
  748.                               4. Change Payments on Account
  749.                               5. Accounts Receivable Menu
  750.                               6. Reports Menu
  751.                               7. Utilities Menu
  752.                               8. Exit Program                 
  753.                                                          
  754.           1. Enter Invoice Data
  755.             
  756.           To begin entering new  invoices, press <1>, <e> or  <E> (Rosewood
  757.           Journal is not case sensitive). You then will be presented with a
  758.           screen which  will ask you  the month and  the year in  which you
  759.           want the invoices entered.  The default is the current  month and
  760.           year if you are just starting the program, or the  month that you
  761.           have  been  working on  in another  part of  the program.  If the
  762.           current date,  for  example,  is  October  1990,  these  are  the
  763.           defaults, and  if that is the  month and year you  wish, you only
  764.           need press  <Enter> to accept them.  If it is not  the month that
  765.           you wish, you can (a) type the  name of the month in full  (upper
  766.           case or lower case or a combination of both), (b)  type the first
  767.           three letters of  the month, or (c) type the  number of the month
  768.           (1 for  January, 3 for March etc.). If the default year is wrong,
  769.           type the year that you wish in full (1990 for example).The screen
  770.           will then clear and the "Enter Invoices" screen will appear.
  771.  
  772.           First, you will  be asked to  "Enter Invoice  Number or <Esc>  to
  773.           quit". There also will be a default invoice number  shown. If you
  774.           have stumbled onto this screen by mistake, you only have to press
  775.           <Esc>  to go back to the Main Menu.  If it is the first time that
  776.           invoices  have been  entered for  this month, the  default number
  777.           will be "1". If invoices already have been entered for the month,
  778.           the default number will  be the last invoice number  entered plus
  779.           one. If the default number is  not the same as the invoice number
  780.           you  intend to enter, you  should enter the  proper number (up to
  781.           six digits, numerical  only). If the  default number is  correct,
  782.  
  783.                                           13
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.                                    ROSEWOOD JOURNAL
  792.  
  793.  
  794.           you only need to  press <Enter>. Subsequent invoice  numbers will
  795.           be increased  by one each  time, thus  saving keystrokes.  PLEASE
  796.           NOTE that  Rosewood  Journal  will  not  complain  if  you  enter
  797.           identical  invoice numbers  in any  given month,  but  the report
  798.           results may be inaccurate. You may have identical invoice numbers
  799.           in different months without incurring any problems.
  800.  
  801.           You next  will be asked  to "Enter the  Invoice Date  (e.g. 15)".
  802.           This means the day  of the month. The default is  "1" or the date
  803.           of  the last invoice entered in the current session. Again, press
  804.           <Enter>  if the date is correct. Rosewood Journal will not accept
  805.           invalid dates such as February 30.
  806.  
  807.           Next, you will  be asked  to "Enter Customer's  Name". Enter  the
  808.           customer's  name (last name first, please), or you may use one of
  809.           the  softkeys  displayed at  the bottom  of  the screen.  See the
  810.           section under  "Utilities" to learn how  to set up these  keys so
  811.           that frequently  used customer's  names can  be entered  with one
  812.           keystroke. Maximum length is 35 characters if entered manually or
  813.           13 if entered by softkey.
  814.  
  815.           The  next invoice entry item is "Enter  "R" if this Invoice is to
  816.           be Added to Accounts  Receivable". IF ANY PORTION OF  THE INVOICE
  817.           BEING ENTERED HAS NOT BEEN PAID IN FULL PRESS <R> (upper or lower
  818.           case) and <Enter>. See the section on "Enter Payments on Account"
  819.           if  a partial payment has been made. If, however, the invoice has
  820.           been paid in full, then press <C> (for "cash") or <ENTER>. If you
  821.           should, by mistake, press any other key than <R>, <C> or <Enter>,
  822.           Rosewood  Journal  will  complain.  While  in  the  "Enter  Data"
  823.           function <Enter>  has the same effect  as <C> so it  is easier to
  824.           use <Enter>. 
  825.  
  826.  
  827.           Next you will  be asked  to "Enter Gross  Invoice Amount".  Gross
  828.           invoice amount is the "bottom  line", that is, the amount of  the
  829.           sale INCLUDING  sales tax(es).  After entering the  gross invoice
  830.           amount, you will be  asked to "Enter Sales Tax  #1 amount". Enter
  831.           the  amount of  the sales  tax or,  if it  is zero,  simply press
  832.           <Enter>. Do the same for "Enter Sales Tax #2 amount". Please note
  833.           that you can change the number of taxes (0, 1 or 2) and the names
  834.           of the taxes from the "Utilities Menu". If you have made an error
  835.           use the cursor keys to move around the screen to correct it.
  836.  
  837.           Running totals for the  month are listed near  the bottom of  the
  838.           screen for your information.
  839.  
  840.           You  will  then be  presented with  a  decision line  as follows:
  841.           "<Esc>  to stop entering  invoices. <Enter> to  continue". If you
  842.  
  843.  
  844.                                           14
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.                                    ROSEWOOD JOURNAL
  853.  
  854.  
  855.           have finished entering invoices for now, press <Esc>; if you have
  856.           more invoices to enter, press <Enter>.
  857.  
  858.           When you have  finished entering invoices and have pressed <Esc>,
  859.           each invoice for which you have pressed <R> for "receivable" will
  860.           be presented in turn  along with a list of  existing accounts.Use
  861.           <PgUp>,  <PgDn>, <Home>  & <End>  to scroll  through the  list of
  862.           names.  A decision line will be  displayed near the bottom of the
  863.           screen: Press <Enter>  when ready to enter  account number". When
  864.           ready to enter the account number (even if the name is not on the
  865.           list), press <Enter>. You  will then be asked, "To  which account
  866.           do you  wish to put invoice  number xxxxx or press  <0> (zero) to
  867.           open a  new account".  If  the invoice  is to  be  charged to  an
  868.           existing account, enter the number of the account. If it is to be
  869.           charged to  a new account,  press <0> (zero).  If the invoice  is
  870.           charged to an existing account, the next "R" invoice will come up
  871.           on the screen and the process is repeated until there are no more
  872.           "R" invoices, at  which time  you will  be returned  to the  Main
  873.           Menu.  If you have pressed <0>  for a new account, another screen
  874.           will come up and you will be asked to enter the name, address and
  875.           phone number  of the  customer. After entering  this information,
  876.           the next "R" invoice will come up,  or, if there are no more, you
  877.           will be returned to the Main Menu.
  878.  
  879.           2. Change Invoice Data
  880.  
  881.           If you discover that you have made an error entering invoice data
  882.           which was not corrected at the time of entry, you may correct the
  883.           error  by using  the "Change  Invoice Data"  option. You  will be
  884.           asked the month and  year for the invoice. After  entering these,
  885.           you  will be shown the list of  invoices for that month. When you
  886.           have found the invoice that you wish to change, press <Enter> and
  887.           then  enter  the  invoice number.  You  will  be  shown a  screen
  888.           containing the  invoice as  originally entered. Make  any changes
  889.           required and the data will  be updated. You may press <Enter>  to
  890.           accept  any  line as  is. If  the invoice  as  changed is  an "R"
  891.           invoice, you will be asked to assign it to an account as was done
  892.           in the "Enter Invoice Data" option above.
  893.  
  894.           3. Enter Payments on Account
  895.  
  896.           This  option serves  two  purposes. The  first  is to  enter  any
  897.           deposits  or  down-payments  entered  on  invoices  so  that  the
  898.           accounts  receivable  will show  the  proper  amount. The  second
  899.           purpose is to enter payments made to accounts, typically recorded
  900.           in a receipt book. In either case, you will be asked to enter the
  901.           month and year  in which to  enter the payment.  The screen  will
  902.           then show a list  of customer accounts. You can  move through the
  903.           list using the cursor  keys. Press <Enter> when you  have located
  904.  
  905.                                           15
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.                                    ROSEWOOD JOURNAL
  914.  
  915.  
  916.           the account  number to which you  wish to credit a  payment or if
  917.           you  wish to open a new account. You  will then be asked to enter
  918.           the day of the month on which the payment was made and the amount
  919.           of  the payment.  After  you have  done  this you  will  be asked
  920.           whether you wish  to credit another payment on account or not. If
  921.           you press "Y" the above process  repeats, if "N" you are returned
  922.           to the Main Menu.
  923.  
  924.  
  925.  
  926.  
  927.           4. Change Payments on Account
  928.  
  929.           This option works much like number  3 above and will give you the
  930.           opportunity to change any "On Account" entry.
  931.  
  932.           5. Accounts Receivable Menu
  933.  
  934.           This option transfers you  to the Accounts Receivable  Menu which
  935.           is described later.
  936.  
  937.           6. Reports Menu
  938.  
  939.           This  option transfers you to the Reports Menu which is described
  940.           later.
  941.  
  942.           7. Utilities Menu
  943.  
  944.           This  option  transfers  you  to  the  Utilities  Menu  which  is
  945.           described later.
  946.  
  947.           8. Exit Program
  948.  
  949.           Use  this option  when you are  finished using  Rosewood Journal.
  950.           This is the ONLY acceptable way  to quit the program. Data may be
  951.           lost  if  you reboot  or turn  off  the computer  without exiting
  952.           through  "Exit Program". If you stumble into the exit screen, you
  953.           will be given an opportunity to go back to the program.
  954.  
  955.                                ACCOUNTS RECEIVABLE MENU
  956.  
  957.                          1.  View or Print Individual Accounts
  958.                          2.  Print All Statements for Month
  959.                          3.  Establish New Customer Accounts
  960.                          4.  Modify Customer Accounts
  961.                          5.  List Customer Accounts
  962.                          6.  Reports Menu
  963.                          7.  Exit to Main Menu
  964.  
  965.  
  966.                                           16
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.                                    ROSEWOOD JOURNAL
  975.  
  976.  
  977.           1. View or Print Individual Accounts
  978.  
  979.           This option  allows you  to  view (on  the screen)  or print  (on
  980.           paper)  an individual  customer's account  as of  the end  of any
  981.           month that you choose. After entering the month and the year, you
  982.           will  be presented with  the following decision  line: "Enter the
  983.           number that you wish  to view or <Enter> to view  active accounts
  984.           or <X> to exit". If you know the account number which you wish to
  985.           view, simply enter that number,  and the customer's statement for
  986.           that  month will  be printed on  the screen,  or on  paper as you
  987.           choose.  If you do not know the  account number for the customer,
  988.           press <Enter> and  you will be presented with a  list of existing
  989.           accounts. Another  decision line  will appear as  follows: "Press
  990.           <Enter> when ready  to enter account number".  After locating, by
  991.           scrolling  if necessary, the account  you wish to  view or print,
  992.           press <Enter> and  type in the account  number that you  wish. As
  993.           above, that account will be processed for viewing or printing.
  994.  
  995.           2. Print All Statements for Month
  996.  
  997.           This  option allows  you  to print  or  view statements  for  all
  998.           accounts as of the end of any specified month. Accounts with zero
  999.           balances but  with activity  during the  specified month  will be
  1000.           printed. Other accounts with zero  balances will not be  printed.
  1001.           These  statements are  designed to fit  properly into  a standard
  1002.           business size window envelope. After the printing starts, you may
  1003.           press <Esc>  to stop  the printing after  the end of  the current
  1004.           statement. You will  be given the option to continue  at the next
  1005.           statement or to exit to the Accounts Receivable menu.
  1006.  
  1007.           3. Establish New Customer Accounts
  1008.  
  1009.           This  option is  provided  for  those  people  who  may  wish  to
  1010.           establish new  customer accounts before entering  invoices. It is
  1011.           only necessary  to enter the  customer's name, address,  etc. The
  1012.           same  process  is  entered  into automatically  from  the  "Enter
  1013.           Invoice Data" option on the Main Menu.
  1014.  
  1015.           4. Modify Customer Data
  1016.  
  1017.           You may make  any changes  in a customer's  name, address,  tele-
  1018.           phone, etc. from  this option. You will be  presented with a list
  1019.           of existing accounts from which to choose.
  1020.  
  1021.           5. List Customer Accounts
  1022.  
  1023.           This option  allows you  to list,  on the screen  or on  paper, a
  1024.           complete  list  of  all  existing customer  accounts  along  with
  1025.           addresses and telephone numbers. This list can make it simpler to
  1026.  
  1027.                                           17
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.                                    ROSEWOOD JOURNAL
  1036.  
  1037.  
  1038.           view  individual  statements because  you will  not have  to wait
  1039.           while all accounts are printed on the screen before selecting the
  1040.           one account that you wish.
  1041.  
  1042.           6. Reports Menu
  1043.  
  1044.           Selecting this option transfers you to the Reports Menu.
  1045.  
  1046.           7. Exit to Main Menu
  1047.  
  1048.           This returns you to the Main Menu.
  1049.  
  1050.                                      REPORTS MENU
  1051.  
  1052.                               1. Monthly Report
  1053.                               2. Yearly Report
  1054.                               3. Accounts Receivable List
  1055.                               4. Payments on Account List
  1056.                               5. General Ledger Report
  1057.                               6. Accounts Receivable Menu
  1058.                               7. Exit to Main Menu
  1059.  
  1060.           1. Monthly Report
  1061.  
  1062.           This  option produces a summary  for any particular  month of all
  1063.           invoices for  that month. It may  be printed on the  screen or on
  1064.           paper.
  1065.  
  1066.           2. Yearly Report
  1067.  
  1068.           This  produces a report showing  the individual monthly totals of
  1069.           invoices for any fiscal year in which invoices have been entered.
  1070.           The report can be printed on screen or on paper.
  1071.  
  1072.           3. Accounts Receivable List
  1073.  
  1074.           This  option produces a list  of all customer  accounts with non-
  1075.           zero balances as  of the end of any month requested. The accounts
  1076.           are "aged"; that is, the amounts for any customer account will be
  1077.           listed  as  "current", "30  days",  "60  days",  or  "90+  days".
  1078.           Negative balances will always be shown as current.
  1079.  
  1080.           4. Payments on Account List
  1081.  
  1082.           This produces a  list of  payments to customer  accounts for  any
  1083.           selected month.
  1084.  
  1085.  
  1086.           5. General Ledger Report
  1087.  
  1088.                                           18
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.                                    ROSEWOOD JOURNAL
  1097.  
  1098.  
  1099.           This report  gives you a  summary of  amounts to be  entered into
  1100.           your general ledger (whether  it be a manual or  computer system)
  1101.           and tells you the accounts to which the totals are to be entered.
  1102.           The general  ledger accounts  to which information  from Rosewood
  1103.           Journal is to  be entered are: 1) Sales Account,  2) Sales Tax #1
  1104.           Payable Account, 3)  Sales Tax  #2 Account, 4)  Bank Account,  5)
  1105.           Accounts  Receivable  Account.  Your   system  may  use  somewhat
  1106.           different  names  for these  accounts but  they  will be  in your
  1107.           bookkeeping  system.  Ask your  accountant  for  help with  these
  1108.           account names, if  necessary. If  your business  has no  accounts
  1109.           receivable  (none of  your  customers ever  owes you  money), the
  1110.           entries  for accounts receivable will be zero and can be ignored.
  1111.           This  report also lists an "Audit Trail". This lists all accounts
  1112.           receivable activity  for the  selected month  as it  was actually
  1113.           entered  into the computer. It will help you to find entry errors
  1114.           (e.g. entering an invoice to account  12 instead of 11). You  can
  1115.           compare the "Monthly Report",  the "Payment on Account" list  and
  1116.           the  "Audit Trail"  to insure  that data  was entered  correctly.
  1117.           Accountants and auditors  love audit trails  and this report  may
  1118.           please and calm them.
  1119.  
  1120.           6. Accounts Receivable Menu
  1121.  
  1122.           This option transfers you to the Accounts Receivable Menu.
  1123.  
  1124.           7. Exit to Main Menu
  1125.  
  1126.           This option returns you to the Main Menu.
  1127.  
  1128.  
  1129.  
  1130.                                     UTILITIES MENU
  1131.  
  1132.                          1. Change Company Details
  1133.                          2. Dos Functions
  1134.                          3. End of Period Housekeeping
  1135.                          4. Change Screen Colours
  1136.                          5. Change Tax Names
  1137.                          6. Change Softkey Settings
  1138.                          7. Print Mailing Labels
  1139.                          8. Exit to Main Menu
  1140.  
  1141.           1. Change Company Details
  1142.  
  1143.           This option allows you  to change details of YOUR  company (name,
  1144.           address etc.) and  the drive and/or  directory where the  program
  1145.           data can be found. The directory and sub-directory name can be up
  1146.           to 29 characters  long. The program actually allocates  30 spaces
  1147.           but  reserves 1 space for  a trailing "\"  which is automatically
  1148.  
  1149.                                           19
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.                                    ROSEWOOD JOURNAL
  1158.  
  1159.  
  1160.           added  if you  do not  do it  yourself. See  your DOS  manual for
  1161.           details on  drives, directories and  paths. In addition,  you can
  1162.           choose the month in which your fiscal year begins.
  1163.  
  1164.                                       WARNING!!
  1165.  
  1166.                The fiscal  year should  be chosen BEFORE  invoices are
  1167.                entered because the file  which holds the yearly totals
  1168.                is initialized  with this option.  If you are  going to
  1169.                change your fiscal year, it is best to start a new data
  1170.                disk  so that  the  data can  be entered  properly. If,
  1171.                through  some  mishap  (we  all make  them),  you  have
  1172.                entered or  changed to  a wrong  fiscal year after  you
  1173.                have entered  invoices, you must follow  these instruc-
  1174.                tions to rectify the problem:
  1175.  
  1176.                     1. From DOS, erase  the current yearly  total
  1177.                     file.  This will be  called "TOTALS88.DAT" if
  1178.                     the year is 1988;  "TOTALS89.DAT" if the year
  1179.                     is 1989, etc.
  1180.  
  1181.                     2. From Rosewood  Journal, enter the  "Change
  1182.                     Invoice Data" option from the Main Menu. Make
  1183.                     a "null" change in  one invoice in each month
  1184.                     in the year for which you have data. That is,
  1185.                     call  up one  invoice  for  changing in  each
  1186.                     month, but simply press <Enter> for each item
  1187.                     such as name, gross invoice amount, etc. This
  1188.                     will  "fool" the  program into writing  a new
  1189.                     and correct year total file.
  1190.  
  1191.                If  this  seems  complex,  please  remember  that  this
  1192.                procedure probably  never will  need to be  done. Also,
  1193.                you  are most  likely to make  this error  when experi-
  1194.                menting with the program rather than when you are using
  1195.                it.
  1196.  
  1197.  
  1198.           2. DOS Functions
  1199.  
  1200.           This option  will "shell" you  to DOS. You  may run  a directory,
  1201.           erase a  file, or even run another program. When you are ready to
  1202.           return to Rosewood Journal, type "Exit" and press <Enter>. A copy
  1203.           of "COMMAND.COM" must be installed where DOS can find it.
  1204.  
  1205.           3. End of Period Housekeeping
  1206.  
  1207.           This option "cleans  up" the accounts receivable files.  Clean up
  1208.           is needed from time  to time because all receivable  data remains
  1209.  
  1210.                                           20
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.                                    ROSEWOOD JOURNAL
  1219.  
  1220.  
  1221.           in  the files,  "RECEIVE.DAT"  and "CUSTACCT.DAT",  even if  some
  1222.           accounts have  been paid and  therefore have zero  balances. This
  1223.           data  is  kept because  you may  wish to  find  the status  of an
  1224.           account  as of  several  months ago.  Eventually, the  receivable
  1225.           files will  become so  large that the  speed of the  program will
  1226.           become  unacceptably slow. When  this will happen  depends on how
  1227.           many accounts receivable entries you have and your patience  when
  1228.           waiting for  a listing of  accounts receivable. The  most natural
  1229.           time to invoke this option is at the end of your fiscal year. You
  1230.           will  be asked  for  the month  to  start the  housekeeping.  For
  1231.           example, if  you choose December  1990, the program  will examine
  1232.           each customer account in turn. Let us say that your first account
  1233.           is for "Able Cleaners".  Any "R" invoices or payments  on account
  1234.           for  Able Cleaners  in December 1990  will be  left as  they were
  1235.           entered with no changes.  All "R" invoices for Able  Cleaners for
  1236.           November 1990 will  be combined into one entry which will have an
  1237.           "invoice" number beginning with "A". All payments made by Able in
  1238.           November will likewise be combined  into one entry beginning with
  1239.           "Q".  Another  set  of entries  will  be  made  for invoices  and
  1240.           payments made  in October (60  days). Invoices and  payments from
  1241.           September  and older (90+ days) will similarly be combined except
  1242.           if  the  net amount  (invoices  minus payments)  for  that period
  1243.           equals zero, no  new entries  will be made.  By combining  recent
  1244.           invoices and payments and deleting old ones which have been paid,
  1245.           the  size of  the  "RECEIVE.DAT" file  is  reduced and  speed  is
  1246.           increased.  After  this  stage   of  the  housekeeping  has  been
  1247.           completed you will  be shown the name and number of each customer
  1248.           account  which has a zero balance. You  will be given a choice of
  1249.           keeping or deleting it.  If you will be using this  account again
  1250.           within a reasonable time, keep  it. If not, it is best  to delete
  1251.           it. Please note  that deletions do not reduce  the actual size of
  1252.           the "CUSTACCT.DAT" file  but the file will  "work" faster because
  1253.           the deletions will be by-passed. Deleted account  numbers will be
  1254.           re-used as you add new accounts.
  1255.  
  1256.           After  the housekeeping  process is  complete, the  original data
  1257.           will be saved in files named, "RECEIVE.OLD" and "CUSTACCT.OLD".
  1258.  
  1259.           IT  IS STRONGLY  URGED THAT  YOU MAKE  A COPY  OF YOUR  DATA DISK
  1260.           BEFORE BEGINNING THE HOUSEKEEPING PROCESS.
  1261.  
  1262.           If you  have made a disk  back-up of your data  files, the ".OLD"
  1263.           files can be deleted. If you have not made a  back-up, the ".OLD"
  1264.           can always be renamed to ".OLD" files from DOS.
  1265.  
  1266.           4. Change Screen Colours
  1267.  
  1268.           If  you have colour monitor, you can change the screen colours to
  1269.           your own liking. Simply follow the prompts on the screen and when
  1270.  
  1271.                                           21
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.                                    ROSEWOOD JOURNAL
  1280.  
  1281.  
  1282.           the  selection  is complete  your new  colour  scheme will  be in
  1283.           effect.  If you wish  you can return  to the  default settings by
  1284.           pressing <D> for "Default" when prompted.
  1285.  
  1286.           5. Change Tax Names
  1287.  
  1288.           As shipped, Rosewood Journal is set to  account for two levels of
  1289.           sales tax, "Sales Tax #1" and "Sales Tax #2". You can change this
  1290.           to one sales tax or none depending on the needs of your business.
  1291.           In  addition,  you  can change  the  name(s)  of  the tax(es)  to
  1292.           whatever you choose. The  only restriction is that the  length of
  1293.           the names must not exceed 12 characters and spaces.
  1294.  
  1295.  
  1296.  
  1297.           6. Change Softkey Settings
  1298.  
  1299.           Rosewood Journal uses two separate  "softkey lines". The first is
  1300.           displayed at the bottom of the "Enter Invoice" screen, the second
  1301.           at the bottom  of the  "Add Customer Accounts"  screen. Both  are
  1302.           there  to  save  you  keystrokes. The  "Enter  Invoice"  softkeys
  1303.           generally are used to enter the names of customers who frequently
  1304.           do  business  with you  (e.g. National  Tar),  or for  a standard
  1305.           amount of an invoice (your  widgets are all sold for 498.64),  or
  1306.           for entries  such as  "Cash  Sale". The  "Add Customer  Accounts"
  1307.           softkeys  are used  for frequently  used names of  towns, cities,
  1308.           states  or provinces.  If you  do most  of your business  in Sas-
  1309.           katchewan, it is nice to be able to enter it  with one keystroke.
  1310.           After choosing the "Change Softkey Settings" option, you  will be
  1311.           asked which of the two softkey lines you wish to enter or change.
  1312.           After making your choice, you will be asked, "Which Softkey would
  1313.           you like to change or  <X> to exit". If, for example, you wish to
  1314.           change F6,  press <6> (not  F6). You  can then type  the text  or
  1315.           numbers that  you want  to have  typed when  you press  <F6>. The
  1316.           maximum length  of the entry  is 13 characters.  Rosewood Journal
  1317.           will  display the first 5  characters in the  appropriate spot on
  1318.           the softkey line.  You may  continue adding  or changing  softkey
  1319.           definitions until you choose the exit <X> option to return to the
  1320.           Utilities Menu.
  1321.  
  1322.  
  1323.           7. Print Labels
  1324.  
  1325.           This  option allows you to print mailing labels for your customer
  1326.           accounts on standard 6 line,  continuous form, continuous feed, 3
  1327.           1/2  inch by 15/16  size labels. You have  the option of printing
  1328.           labels for all or  selected customer accounts. You will  be given
  1329.           an opportunity to print one  or more test labels so that  you can
  1330.           align your printer's print  head before actually printing labels.
  1331.  
  1332.                                           22
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.                                    ROSEWOOD JOURNAL
  1341.  
  1342.  
  1343.           You can  also print any number  of labels for your  own business.
  1344.           These are handy as return address labels.
  1345.  
  1346.           8. Exit to Main Menu
  1347.                This option will transfer you to the Main Menu.
  1348.  
  1349.           FILE LENGTHS AND NAMES IN ROSEWOOD JOURNAL
  1350.  
  1351.           All files  written by Rosewood  Journal are random  access, fixed
  1352.           length with no delimiters between fields  and no carriage returns
  1353.           or line  feeds at  the end  of records. The  data in  the monthly
  1354.           files (e.g. JAN90.DAT)  are all  stored as strings.  The same  is
  1355.           true for the customer account file (CUSTACCT.DAT) except that the
  1356.           customer account number is stored as an integer. 
  1357.  
  1358.  
  1359.           The details of the fields for the monthly files are:
  1360.  
  1361.                Invoice Number:          length 6 bytes
  1362.                Invoice Date:            length 2 bytes
  1363.                Customer Name:           length 35 bytes
  1364.                Gross Invoice Amount:    length 9 bytes
  1365.                Sales tax #1 Amount:     length 8 bytes
  1366.                Sales tax #2 Amount:     length 8 bytes
  1367.                Receivable:              length 1 byte
  1368.                "R" identifies the invoice as receivable
  1369.  
  1370.           Each  record then  is 69 bytes  long whether  or not  some of the
  1371.           fields are empty.
  1372.  
  1373.           The details of the customer account file (CUSTACCT.DAT) are:
  1374.  
  1375.                Account number (integer):length 2 bytes
  1376.                Customer Name:           length 35 bytes
  1377.                Contact:                 length 35 bytes
  1378.                Street:                  length 35 bytes
  1379.                City:                    length 25 bytes
  1380.                Province or State:       length 20 bytes
  1381.                Postal Code or ZIP:      length 12 bytes
  1382.                Phone:                   length 15 bytes
  1383.                Remarks:                 length 35 bytes
  1384.  
  1385.           The total length of each  record in the CUSTACCT.DAT file  is 214
  1386.           bytes.
  1387.  
  1388.           The above should give sufficient information  to export your data
  1389.           to most programs.
  1390.  
  1391.              CONVERTING FILES FROM PREVIOUS VERSIONS OF ROSEWOOD JOURNAL
  1392.  
  1393.                                           23
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.                                    ROSEWOOD JOURNAL
  1402.  
  1403.  
  1404.           Versions 2.xx and  3.xx of Rosewood  Journal used different  file
  1405.           structures  than  version  4.xx.  Older  files  will  have to  be
  1406.           converted  to the  new format.  A  conversion program  which will
  1407.           quickly  and  easily effect  the  change  is  supplied  to  every
  1408.           registered user.
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.                       INTEGRATING YOUR PREVIOUS RECEIVABLE FILES
  1415.  
  1416.           Unless  you are starting  a new business,  it is  likely that you
  1417.           will have accounts receivable "on the books" when you begin using
  1418.           Rosewood Journal. These can  be integrated into Rosewood Journal.
  1419.           Let us assume  that you are starting  to use Rosewood  Journal on
  1420.           the first day  of your fiscal year which begins  January 1, 1990.
  1421.           Using the "Enter Invoice  Data" option for December 1989  (or for
  1422.           whatever month  the previous receivable was  incurred), enter all
  1423.           your previous  receivables as invoices,  being sure to  press the
  1424.           <R> (receivable) option. After you have entered all your previous
  1425.           receivables  and, in the process,  set up accounts  for them, you
  1426.           may, if you wish,  delete the "DEC89.DAT" (or the  other previous
  1427.           months which you may have used) and the "TOTALS89.DAT" file. Your
  1428.           previous  accounts receivable  will  now be  integrated with  the
  1429.           records that you will be entering for 1990.
  1430.  
  1431.  
  1432.                                  PROGRAMMING DETAILS
  1433.  
  1434.           Rosewood Journal is  programmed in Microsoft Quick Basic 4.00 and
  1435.           4.50, in three modules and an "Include" file. It is compiled with
  1436.           Quick Basic 4.50 compiler using  the "/o" (standalone), "/x"  (on
  1437.           error),"/ah"  (arrays larger  than  64K) options.  The  resulting
  1438.           object  files are  linked with  Microsoft Overlay  Linker version
  1439.           3.69 using the "/e" (exepack)  option. The program is extensively
  1440.           error protected, both by  "on error" routines and  by "protecting
  1441.           inputs".  Every effort  has been  made to  prevent the  user from
  1442.           entering  inappropriate data such  as invalid dates, alphabetical
  1443.           data where numerical data is expected, inputs longer than allowed
  1444.           and even spelling mistakes. In many cases the program will give a
  1445.           message  telling you  what  the error  is.  In other  cases,  the
  1446.           program will beep and return you to the input line expecting that
  1447.           you will  realize your  error. Messages  for  every single  error
  1448.           would  unnecessarily bloat  the program.  The error  routines are
  1449.           designed to save  your data wherever  possible. If, however,  you
  1450.           have  placed the  wrong disk in  the drive  which holds  the data
  1451.           (perhaps after shelling to  DOS), you may lose some  data. If you
  1452.           get a message, "Data Disk problem: is the proper disk in place?",
  1453.  
  1454.                                           24
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.                                    ROSEWOOD JOURNAL
  1463.  
  1464.  
  1465.           please use the "Reports"  option to check whether any  data which
  1466.           you have entered after such an  error has in fact been written to
  1467.           the file. The program was written on a Hyperion (more or less IBM
  1468.           compatible,  now defunct)  computer with  640K ram  and  two 360k
  1469.           floppy drives and  a Genix (IBM clone)  80386 with one  40mb hard
  1470.           disk, a 120mb hard disk and  a VGA monitor. All documentation has
  1471.           been written using WordPerfect 5.1. There are no machine specific
  1472.           routines,  so that the program  should run on  any computer using
  1473.           MS/PC DOS 2.00 or higher.
  1474.  
  1475.  
  1476.                                CHANGES AND ENHANCEMENTS
  1477.  
  1478.           Rosewood  Software is  vitally  interested in  your comments  and
  1479.           suggestions, or your ideas for new programs. If you like Rosewood
  1480.           Journal  but  would like  customized  changes  for your  specific
  1481.           business,  please contact us. Hearing from you, the user helps us
  1482.           to provide you with a better product.
  1483.  
  1484.  
  1485.  
  1486.                                       SHAREWARE
  1487.  
  1488.           The only  way that you can  be assured of a  continuing supply of
  1489.           low-cost, quality software for almost any purpose, is to  support
  1490.           Shareware.  Shareware is  non-shrink-wrapped,  low cost  software
  1491.           that  you try  at  your own  convenience.  Shareware is  used  by
  1492.           everyone from individuals to  the largest multi-national corpora-
  1493.           tions.  Shareware, as a marketing concept,  trusts you, the user,
  1494.           to buy it if  you like it. If  you like Rosewood Journal,  and if
  1495.           you use it,  please send  your registration fee  today. For  your
  1496.           convenience, there  is an  order form  (ORDER.FRM) which  you can
  1497.           print from your Rosewood Journal distribution disk.
  1498.  
  1499.  
  1500.           Send your registration fee to:
  1501.  
  1502.                                   ROSEWOOD SOFTWARE
  1503.                                  135-10 LIVONIA PLACE
  1504.                                 SCARBOROUGH   ONTARIO
  1505.                                        M1E 4W6
  1506.                                     (416) 284-6119
  1507.                                 CompuServe 70461,2507
  1508.  
  1509.               Member of The Association of Shareware Professionals (ASP)
  1510.  
  1511.                                      THANK YOU!!
  1512.  
  1513.  
  1514.  
  1515.                                           25
  1516.